home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / cmode.z / cmode
Encoding:
Text File  |  2002-10-03  |  3.3 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ccccmmmmooooddddeeee((((3333GGGG))))                                                            ccccmmmmooooddddeeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ccccmmmmooooddddeeee - sets color map mode as the current mode.
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ccccmmmmooooddddeeee
  13.  
  14. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  15.      _n_o_n_e
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      ccccmmmmooooddddeeee instructs the system to treat color as a 1-component entity in the
  19.      currently active drawmode.  The single color component is used as an
  20.      index into a table of RGB color values called the color map.  Because
  21.      color map mode is the default value for all GL framebuffers, it can be
  22.      called in any of the framebuffer drawmodes (NNNNOOOORRRRMMMMAAAALLLL,,,, PPPPUUUUPPPPDDDDRRRRAAAA,,,, OOOOVVVVEEEERRRRDDDDRRRR,,,, and
  23.      UUUUNNNNDDDDEEEERRRRDDDD).  To return the normal framebuffer to color map mode, however,
  24.      you must call ccccmmmmooooddddeeee while in drawmode NNNNOOOORRRRMMMMAAAALLLL.  You must call ggggccccoooonnnnffffiiii for
  25.      ccccmmmmooooddddeeee to take effect.
  26.  
  27.      While in color map mode, a framebuffer is configured to store a single
  28.      color index at each pixel location.  The framebuffer is displayed by
  29.      continually translating color indices into RGB triples using the
  30.      framebuffer's color map, a table of index-to-RGB mappings.  The red,
  31.      green, and blue components stored in the color map are used (after
  32.      correction for monitor non-linearity) to directly control the color guns
  33.      of the monitor.  Colors and writemasks must be specified using color
  34.      map-compatible commands such as ccccoooolllloooorrrr, ccccoooolllloooorrrrffff, and wwwwrrrriiiitttteeeemmmm.
  35.  
  36.      Many advanced rendering features, such as texture mapping, polygon
  37.      antialiasing, and fog, are available only in RGB mode.  Color map mode
  38.      lighting, while functional, is substantially less robust than its RGB
  39.      mode counterpart.
  40.  
  41.      Since ccccmmmmooooddddeeee is the default, you do not have to call it unless the normal
  42.      framebuffer was previously set to RGB mode.
  43.  
  44. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  45.      color, drawmo, gconfi, getdis, getgde, multim, onemap, RGBmod, writem
  46.  
  47. NNNNOOOOTTTTEEEE
  48.      Color map mode is available in all framebuffers of all hardware
  49.      configurations.  ggggeeeettttggggddddeeee can be used to determine how many bitplanes in
  50.      each of the normal, popup, overlay, and underlay framebuffers are
  51.      available in both single and double buffered color map mode.
  52.  
  53.      This routine is available only in immediate mode.
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.